home *** CD-ROM | disk | FTP | other *** search
/ Power Utilities / Power Utilities.iso / utility / pro209 / ds.doc < prev    next >
Encoding:
Text File  |  1990-04-07  |  4.8 KB  |  122 lines
  1. DS (Directory Size) - Written by Aaron Bredon.
  2. Created using TURBO C, Copyright (C) Borland 1987,1988
  3.  
  4. Version 4.5 - April 8, 1990
  5.  
  6. *** NOTE *** - The SOURCE CODE and EXECUTABLE program are PUBLIC DOMAIN.
  7.  
  8. This Directory size program written in Turbo C 2.0 is very versatile.
  9. It includes a good usage report (DS ? or any invalid option).
  10.  
  11. Occasionally the reported space used will not correspond to CHKDSK's report
  12.     (The total of Hidden, Directories, and Regular filesin CHKDSK).
  13. This is because a directory had enough files deleted to 
  14.     reduce the number of sectors it COULD occupy (if compressed)
  15. if anyone can find a simple way to regain the clusters, has any questions,
  16. or can give me any suggestions on how to improve this program,
  17. PLEASE call or write me.
  18.  
  19. My phone number is    (609)924-5976,
  20. and my address is:
  21.         Aaron Bredon
  22.         521 State Rd.
  23.         Princeton, NJ 08540
  24.  
  25.  
  26.  
  27. Syntax:        DS [options] [pathnames]
  28.         DS ?
  29.  
  30.     DS ? will give a usage screen with options listed.
  31.     wildcards are allowed in pathnames and are used as file match masks.
  32.     currently, up to 10 pathnames are allowed.
  33.     The program provides one output per path.
  34.     if no path is specified, DS uses the current directory.
  35.  
  36. Options:                        Default
  37.     -a    show all files                (OFF)
  38.         This option, when on, will display all files
  39.         meeting the pathname mask in all directories
  40.         searched.
  41.     -b    show attribute instead of time        (OFF)
  42.         This option, when on, will display file attributes
  43.         in place of the Hour:minute Time
  44.         (only applicable with -a, -s, or -x)
  45.     -c    show # of clusters used by file        (OFF)
  46.         This option, when on, will display file sizes
  47.         by number of clusters used, not by bytes used.
  48.         (only applicable with -a, -s, or -x)
  49.     -d    split screen display (2 columns)    (OFF)
  50.         This option will display files in two columns.
  51.         (only applicable with -a, -s, or -x)
  52.     -f    base on file size, not clusters used    (OFF)
  53.         This option means totals will be based on
  54.         the sum of the file sizes in bytes, not disk
  55.         space actually used.
  56.     -h    count hidden & system files        (ON)
  57.         This option means files with the hidden and system
  58.         attributes will be displayed and counted in totals.
  59.     -i    include subdirectory space        (ON)
  60.         This option will calculate subdirectory size based
  61.         on the  number of files in the directory.
  62.         (If a lot of files have been deleted, the subdirectory
  63.         may actually take more space than this, but it is
  64.         usually fairly accurate)
  65.     -lxxxx    Force clusters to be xxxx bytes.    (actual)
  66.         0 = use actual size.
  67.         This option can be used to calculate how much space
  68.         a group of files will take on a disk with different
  69.         sized clusters(e.g. a floppy disk).
  70.     -n    show full path                (OFF)
  71.         This option will display two columns.  the left column
  72.         will show the full pathname, while the right will
  73.         show the filename and information.
  74.         (only applicable with -a, -s, or -x)
  75.     -o    show path & size ONLY            (OFF)
  76.         This option will display files as in the older versions
  77.         of this program: the size followed by the path.
  78.         This is useful to get the path and still fit
  79.         files in two columns with -d, or if the full
  80.         pathname is more than 40 characters long.
  81.     -p    paged listing                 (OFF)
  82.         This option will pause at the end of each screen
  83.         and ask you to hit a key.
  84.     -qxx    set lines between pauses to xx.        (25)
  85.         This option is useful on non-EGA/VGA screens with
  86.         more than 25 lines/page.
  87.     -r    recurse through subdirectories        (ON)
  88.         This option(normally ON) is useful when you only want
  89.         to calculate the size of files in one directory,
  90.         NOT including subdirectories.
  91.     -s    show subdirectories            (OFF)
  92.         This option is useful in figuring out how much space
  93.         is used by each of your subdirectories.
  94.         (especially with the -n or -o options)
  95.     -x    info on current directory only        (OFF)    (eXtended DIR)
  96.         This option acts like the DIR command, except
  97.         that subdirectory sizes are calculated by recursion,
  98.         and displayed as well.
  99.         (this option turns on the -a option as well)
  100.         ( the effects of the -a and -s options are changed
  101.         by this option)
  102.     -z    show total size                (ON)
  103.         This option controls whether the summary information
  104.         on the total size of the files found is displayed.
  105.  
  106. Some possible uses:                    Command
  107.                         
  108.     1.    Find out the size of a directory    DSIZE path
  109.     2.    DIRectory including subdirectory sizes    DSIZE -x -d -p -i path
  110.             (paged, 2 column)
  111.     3.    Show all files on disk            DSIZE -a drive:\
  112.     4.    Show all directories on disk        DSIZE -s drive:\
  113.     5.    Find a file anywhere on disk        DSIZE -a drive:\fname
  114.     6.    Find out how much space the contents
  115.         of a directory would take on a floppy.    DSIZE -l1024 path
  116.  
  117. Recommendations:
  118.     1.    Make a batch file XD.BAT (eXtended Directory)
  119.         that calls DS with the following options:    -x -d -p -i
  120.     2.    Make a batch file FF.BAT (Find File)
  121.         that calls DS with the following options:    -a c:\%1
  122.